home *** CD-ROM | disk | FTP | other *** search
/ The Complete Windows Set / The Complete Windows Set.iso / SOFTERM / HOSTMODE.DOC < prev    next >
Text File  |  1992-08-18  |  26KB  |  633 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                       Host Mode
  8.                       The Softerm Host mode provides a general-purpose,
  9.                       unattended, remote access mode which can be used
  10.                       interactively by other terminals and systems.  This is
  11.                       similar to an electronic BBS.
  12.  
  13.                       Capabilties
  14.                       o Automatically answer incoming calls (with optional
  15.                         password protection provided by the SOFTERM.PWD file
  16.                         created with the PWDEDIT utility program)
  17.                       o Send and receive files using any protocol supported
  18.                         by Softerm
  19.                       o Function as a server for the Kermit-Server and
  20.                         Softrans file transfer protocols (meaning that a
  21.                         command to initiate the file transfer is not
  22.                         required)
  23.                       o Process DOS-type commands, such as:  DIR, TYPE,
  24.                         DELETE, RENAME
  25.                       o Process Script files automatically or on demand
  26.  
  27.                       Enter Host Mode
  28.                       Host mode is initiated by running the HOST() command
  29.                       from a Script file, such as:
  30.  
  31.                       > HOST (20,30,hangup,yes,'automenu.scr')
  32.  
  33.                       Note:  Host mode will go into effect with the current
  34.                       Speed, Data Bits, Stop Bits, Parity and Duplex
  35.                       parameters.
  36.  
  37.                       Operation
  38.                       When Host mode is in effect, Softerm will wait for a
  39.                       connection to be established.  If the optional logon
  40.                       processing is specified, a caller must supply a
  41.                       recognized username and password before Softerm
  42.                       displays the READY prompt and responds to valid
  43.                       commands.
  44.  
  45.                       Once initiated, Softerm will wait for a connection to
  46.                       be established if one is not already present, display
  47.                       a READY message after processing an optional logon,
  48.                       and wait for requests received through remote terminal
  49.                       interaction, or the Softrans or Kermit protocols.
  50.  
  51.                       A system in the Host mode functions in a passive
  52.                       manner, responding only to requests from the calling
  53.                       terminal or system.  Host mode allows completely
  54.                       unattended operation.  If logging is active, all
  55.                       commands processed, including error messages, will be
  56.                       recorded in the log file.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                       The TIMEOUT assignable system variable (in the Script
  64.                       language) does not affect file transfer operations
  65.                       initiated from the Host mode which has fixed or
  66.                       profiled timeout and retry parameters for all
  67.                       protocols supported.  The Softrans and Kermit
  68.                       protocols and Xmodem receive operations use a 10-
  69.                       second timeout interval and allow for 5 retries.
  70.                       Xmodem send operations will timeout after
  71.                       approximately 70 seconds.  The Character protocol uses
  72.                       a 30-second timeout on transmit and a 60-second
  73.                       timeout on receive.
  74.  
  75.                       The Host mode also provides an option to automatically
  76.                       run a script file on connecting after a successful
  77.                       login.  This can be used to display user welcome
  78.                       messages, instructions on how to perform various user-
  79.                       defined operations, or a security automatic callback
  80.                       capability.
  81.  
  82.                       Important
  83.                       To provide caller interaction, such as displaying a
  84.                       menu and waiting for a key, you will need to use the
  85.                       XMIT:WAIT Script file command.  To simply display a
  86.                       welcome message, you could use the file transfer SEND
  87.                       command using Character protocol.
  88.  
  89.                       The CALL command is provided to run script files
  90.                       interactively when requested by remote users.  The
  91.                       TERMINATE command lets a remote user terminate the
  92.                       Host mode to interact directly with the script file
  93.                       which initiated the Host mode.
  94.  
  95.                       Once the Host mode is initiated, it normally will
  96.                       remain active until terminated locally.
  97.  
  98.                       Optional Logon and Password Processing
  99.  
  100.                       Softerm provides an optional logon security feature
  101.                       to restrict access to the Host mode.  It includes the
  102.                       capability to assign a default directory to each
  103.                       user, and to restrict the type of commands each
  104.                       caller can process while using the Host mode.
  105.  
  106.                       To implement this feature, a special password file
  107.                       called SOFTERM.PWD must be created in the same
  108.                       directory as Softerm's system read files.  The
  109.                       password file is created with PWDEDIT.EXE, a GUI
  110.                       utility program supplied with Softerm Modular.  Note:
  111.                       PWDEDIT is documented completely through the online
  112.                       Help system.  Just press F1 or select the Help
  113.                       pushbutton.
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                                               - 2 -
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.                       SOFTERM.PWD is a fixed-format ASCII file that appears
  128.                       similar to the following if the DOS TYPE command is
  129.                       used:
  130.  
  131.                       C:\SOFTERM>TYPE SOFTERM.PWD
  132.                       Jones, John        M_Ambrosius
  133.                                     <
  134.  
  135.                       Although access restrictions won't appear, names and
  136.                       passwords do.
  137.  
  138.                       Upper- and lower-case characters, except spaces, are
  139.                       valid in the username and password fields and must be
  140.                       matched exactly when entered by a remote user.  Each
  141.                       user name must be unique.  Multiple entries with the
  142.                       same user name are not valid and only the first
  143.                       occurrence can be matched.
  144.  
  145.                       When a remote user connects to a system in Host mode,
  146.                       and a SOFTERM.PWD file is found in the system
  147.                       directory, the following logon sequence is processed:
  148.  
  149.                       Host displays   User types
  150.                       Login           Username followed by CR
  151.                       Password        Password followed by CR
  152.                                       (echo is suppressed during entry of
  153.                                       the password)
  154.                       Ready           Any valid host mode command
  155.  
  156.                       Important:  Username and Password are case sensitive.
  157.                       For example, if the Username was created as SETH, it
  158.                       must be entered in upper- case characters.
  159.  
  160.                       If an error is made when entering the Username or
  161.                       Password, press Esc to cancel the entry and repeat
  162.                       the prompt.  If either the Username or Password is
  163.                       invalid when entered, the logon sequence will be
  164.                       repeated.  After four unsuccessful attempts to logon,
  165.                       a disconnect will occur.
  166.  
  167.                       Once a successful logon has been completed, any valid
  168.                       Host mode command or Softrans and Kermit file
  169.                       tra